home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 006a / pcbspy10.zip / PCBSPY.DOC < prev    next >
Text File  |  1993-05-13  |  9KB  |  275 lines
  1. Trademarked names are the property of the respective owners    
  2.  
  3.  
  4.  
  5.                              PCBSPY v1.0
  6.                        (C) 1993 Nils Antonsen
  7.                  The PCBOARD node monitoring utility
  8.             with a mouse-driven graphical user interface
  9.  
  10.             Supports PCBOARD v14.5/v15.0 up to 100 nodes
  11.  
  12.  
  13.  
  14.  
  15. 1. REQUIREMENTS
  16.  
  17.       A VGA-compatible graphics adapter
  18.       640k of memory 
  19.       A 386-PC or higher is recommeded
  20.  
  21.  
  22.  
  23. 2. DESCRIPTION
  24.  
  25. PCBSPY is a node-monitoring-utility like CDC's PCBMONI. Unlike
  26. other programs of its kind PCBSPY works internaly with some
  27. kind of multitasking to get more information about the user
  28. that is online (like security level or upload-download ratio
  29. etc.) .
  30.  
  31. PCBSPY has the following features:
  32.  
  33.  
  34.       A mouse-driven GUI for VGA-compatible graphics adapters
  35.  
  36.       The ability to supervise up to 100 nodes.
  37.  
  38.       The ability to overview from 8 to 35 nodes in one window.
  39.  
  40.       The ability to display under each node a small portions
  41.       of the User Record of the online user.
  42.  
  43.       The ability to display the complete User Record of an
  44.       online user.
  45.  
  46.       The ability to display the Caller Log of each node. If
  47.       PCBOARD updates the caller's log file, PCBSPY immediately
  48.       updates its Caller Log window.
  49.  
  50.       The ability to call PCBSM, PCBSETUP and PCBFILER from
  51.       inside PCBSPY.
  52.  
  53.       The ability to use a node-inspecting-tool like Network
  54.       Eye or Lan Assist.
  55.  
  56.       The ability to search for up to 10 callers on the network
  57.       and to be alerted if they log into your BBS. 
  58.  
  59.  
  60. 3. INSTALLATION
  61.  
  62. When you start PCBSPY.EXE for the first time, it will ask you
  63. for the path to the PCBOARD.DAT file. Together with other
  64. settings this information will be placed in a binary file
  65. called PCBSPY.CFG. Whenever you start PCBSPY again it will
  66. search in the CURRENT DIRECTORY for the configuration's file
  67. and then start immediately without asking any questions.
  68.  
  69. However, after getting into the desktop, you should addjust
  70. the standart settings in the 'Options' [ALT+o] menu.
  71. Especially you should addjust the 'Usernet Options'. (The
  72. 'Number of Nodes' default value is 25 so if you have actually
  73. more then 25 active nodes no status changes on nodes higher
  74. than 25 will by detected.)
  75.  
  76.       -> start PCBSPY.EXE 
  77.       -> enter the path to the PCBOARD.DAT file 
  78.       -> addjust the settings from the 'Options' menu
  79.  
  80.  
  81. 4. DETAILED DESCRIPTION
  82.  
  83. On the top of the desktop there is a menu bar with five items:
  84. PcbSpy  Externals  Display  Node  Options
  85.  
  86.  
  87. PcbSpy [Alt+p]
  88.  
  89. The 'About ...' item will show you a little copyright notice
  90. on the screen.
  91.  
  92. The 'Exit' item will terminate PCBSPY and get you to the DOS
  93. promt.
  94.  
  95.  
  96. Externals [Alt+e]
  97.  
  98. From this menu you can call the external programs PCBSETUP,
  99. PCBSM and PCBFILER or a DOS-shell. After terminating them you
  100. will get back to PCBSPY. These items are associated with the
  101. Options/Externals dialog box where you enter the corresponding
  102. paths and filenames.
  103.  
  104.  
  105. Display [Alt+i]
  106.  
  107. In this menu you choose between different screen modes,
  108. depending on the number of nodes your BBS provides. Test them
  109. all! You will quickly discover which combination fits the best
  110. your needs.
  111.  
  112.  
  113. Node [Alt+n]
  114.  
  115. The 'View User Record' item displays in a window the User's
  116. Record on that node the cursor points at.
  117.  
  118. The 'View Caller Log' item displays in a window the Caller Log
  119. of the node the cursor points at. As an additional feature
  120. this window will immediately be updated when PCBOARD or a DOOR
  121. writes to the Caller Log file.
  122.  
  123.  
  124. Options [Alt+o]
  125.  
  126. In the 'Externals' dialog box you enter the path and filenames
  127. used for the Externals pull down menu.
  128.  
  129. In the 'Node Inspecting Tool' dialog box you enter the path
  130. and filename to a batch file that uses Node Spy or Lan Assist
  131. or any other tool of that kind. 
  132.  
  133. NOTE:      The FIRST parameter will be the node number.
  134.  
  135. In the 'Screen Saver' dialog box you enter the number of
  136. seconds it takes to activate the screen saver and the
  137. brightness of your screen after the screen saver has been
  138. activated.
  139.  
  140. In the 'Usernet Options' you enter the highest node number to
  141. be supervised and the frequency the USERNET.XXX file should be
  142. read in. 
  143.  
  144. NOTE:      These settings will be activated only after
  145.            restarting PCBSPY.
  146.  
  147. In the 'Highlighted Users' dialog box you enter up to 10 users
  148. you want to be alerted to. If PCBSPY detects one of them
  149. logging into your BBS you get a short acoustic signal and the
  150. node will be highlighted.
  151.  
  152. HINT:      In this dialog box a special feature of the user
  153.            interface makes sense: You can directly release the
  154.            OK-button by the keyboard shortcut [Ctrl+ENTER] so
  155.            you needn't to scroll through all input lines to
  156.            reach the OK-button.
  157.  
  158.  
  159. 5. COPYRIGHT
  160.   
  161. This program and the documentations (the "Software") are the
  162. copyrighted property of Nils P. Antonsen, Switzerland (the
  163. "author"), who provides the Software and licenses its use. 
  164. All rights are reserved.
  165.  
  166.  
  167. 6. DISTRIBUTION
  168.  
  169. Please feel free to upload this software to any electronic
  170. bulletin board and give copies to potential users, so that
  171. others may have the opportunity to obtain a copy for use
  172. according to the license terms mentioned below. 
  173.  
  174. You are specifically prohibited from:
  175.  
  176.       Charging fees or asking donations in exchange of or
  177.       payment for copies of the Software.
  178.  
  179.       Distributing this Software with commercial products
  180.       without the written permission from the author.
  181.  
  182.       Distributing this Software via a for-profit organization
  183.       or group, either alone or with other Software.
  184.  
  185. The unauthorized copying, decompiling or disassembling of this
  186. Software is prohibited; any other use of this Software is
  187. prohibited without a written permission in advance from the
  188. author.
  189.  
  190.  
  191. 7. DISCLAIMER
  192.  
  193. PCBSPY IS PROVIDED 'AS IS' WITHOUT WARRANTY OF ANY KIND,
  194. EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  195. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  196. PARTICULAR PURPOSE. IN NO EVENT IS ANY LIABILITY ACCEPTED FOR
  197. ANY DAMAGES INCURRED, EITHER DIRECTLY OR INDIRECTLY, AS A
  198. RESULT OF USING PCBSPY.
  199.  
  200. 8. REGISTRATION
  201.  
  202. PCBSPY is not free. If you use this Software for more than a
  203. 20-day trial period you must pay for it. 
  204.  
  205.       PCBSPY costs only: $30.- US
  206.                      or: sFr. 40.- 
  207.  
  208. As a restriction of an unregistred evaluation copy a shareware
  209. notice appears when PCBSPY will be started. After some hours
  210. of usage another notice terminates PCBSPY. (I think this
  211. restriction does not cripple the software. The functionality
  212. is in no other way reduced).
  213.  
  214. If you register you will get a serial number that is
  215. associated with the name of your BBS found in PCBOARD.DAT. Be
  216. carefull: For registration we need exactly that name (case
  217. sensitiv!). After entering the serial number all restrictions
  218. will fall away. (Of cause your number will be valid for the
  219. next versions.)
  220.  
  221. There are different ways to get to your serial number:
  222.  
  223. Send REGISTER.FRM to              Hitline Communications
  224.                                   Ueli Maurer
  225.                                   Unterdorfstr. 7
  226.                                   CH-5212 Hausen (Switzerland)
  227.  
  228. Send REGISTER.FRM via FAX         ++41 56 321 629
  229.  
  230. Send a Message                    - FIDO  2:301/213
  231.                                   - COMPUSERVE 100016,440
  232.                                   - HITLINE BBS to Ueli Maurer
  233.                                     ++41 56 321 800
  234.  
  235. 9. SUGGESTIONS & BUG REPORTS
  236.  
  237. Although PCBSPY was beta-tested by BBS's here in Switzerland,
  238. I can't be sure that special configurations will not end up in
  239. difficulties running it. If you encounter a problem please
  240. discribe it as exactly as possible and send it the same way as
  241. your registration form mentioned above. 
  242.  
  243. If you miss a special features - let me know! I will try to
  244. put it in the next version.
  245.  
  246.  
  247. 10. FUTURE PLANS
  248.  
  249. I have some ideas for the next version:
  250.  
  251.       A screen that gives you all currently available
  252.       informations at once: node activity, user infos, caller
  253.       log.
  254.  
  255.       Some kind of BBS statistics: I will try to get out of the
  256.       caller log things like: # of files downloaded, # of min
  257.       online, # of users online etc. since midnight. 
  258.  
  259.       The ability detecting a loss of connection on a node of
  260.       the network.
  261.  
  262.  
  263. 11. TROUBLESHOOTING
  264.  
  265. Some assumptions PCBSPY makes restrict the configuration of
  266. PCBOARD:
  267.  
  268.       The name of the PCBOARD.DAT file is 'PCBOARD.DAT'.
  269.  
  270.       The extension of the USERNET file is '.XXX'.
  271.  
  272.       The name of the caller log files are 'CLR#' (where # is
  273.       the node number).
  274.  
  275. -------------------------------------------------------------